home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / SERIE_S / S_909 / GER / SYNTAX / EXAMPLE.UI < prev    next >
Text File  |  1998-03-14  |  4KB  |  86 lines
  1. !subnode Quelltext-Beispiel
  2.  
  3. Bevor ich ins Detail gehen werde, möchte ich Ihnen an dieser Stelle ein
  4. Beispiel eines kompletten Quelltextes zeigen, welches Ihnen auch dazu dienen
  5. kann, eigene Quelltexte mit UDO zu erstellen:
  6.  
  7. !begin_quote
  8. !hline
  9. !vinclude syntax/example.u
  10. !hline
  11. !end_quote
  12.  
  13. !subsubheading Erläuterungen
  14.  
  15. Zu Beginn des Quelltextes ist ein Kommentar angegeben, damit man später noch
  16. auf Anhieb erkennen kann, womit sich der Text befaβt. Eine Zeile bewertet
  17. UDO als Kommantar, wenn das erste Zeichen der Zeile ein ''#'' ist.
  18.  
  19. Es folgt eine Zeile, die nur für (!LaTeX) aus!-ge!-ge!-ben wird. Hier set!-zen
  20. wir die für (!LaTeX) un!-ent!-behr!-li!-chen Informationen, wie der Text zu
  21. formatieren ist. Sollten Sie sich nicht mit (!LaTeX) auskennen, so benutzen
  22. Sie diese Zeile zu Beginn Ihrer Quelltexte.
  23.  
  24. Danach wird wiederum eine spezielle Zeile angegeben. In diesem Falle wird
  25. dem ST-Guide mitgeteilt, in welche Rubrik der Hypertext in den Katalog
  26. einzuordnen ist. Kennen Sie sich nicht mit dem ST-Guide aus, so verwenden
  27. Sie einfach diese Zeile zu Beginn Ihres Quelltextes.
  28.  
  29. Nun werden die Informationen für die Titelseite und die Kopfzeilen gesetzt,
  30. die bei einigen Formaten automatische erzeugt werden. (!I)!/title(!i) und
  31. (!I)!/program(!i) bilden eine Einheit, daher sollte beides
  32. zu!-sam!-men!-ge!-nom!-men einen Sinn ergeben. Hier würde bei einigen
  33. Formaten in den Kopfzeilen ""Ein UDO-Bespiel-Quelltext"" aus!-ge!-ge!-ben. Bei
  34. (!I)!/date(!i) wird der Platzhalter (!I)(!/today)(!i) durch das aktuelle
  35. Systemdatum ex!-pan!-diert. Sie können natürlich auch manuell für die Angabe
  36. des Datums sorgen (z.B. (!T)!/date 8.  April 1996(!t).
  37.  
  38. Im Vorspann werden nun noch einige Schalter gesetzt. Die ersten beiden
  39. Schalter sorgen bei Hypertexten, deren Kürzel Sie in den eckigen Klammern
  40. erkennen, für die Ausgabe sogenannter
  41. ''Un!-ter!-in!-halts!-ver!-zeich!-nis!-se''. In diesen werden dann alle
  42. Ab!-schnit!-te und Un!-ter!-ab!-schnit!-te eines Kapitels bzw.  alle
  43. Un!-ter!-ab!-schnit!-te eines Ab!-schnit!-tes in Form eines
  44. Inhaltsverzeichnisses aufgelistet. Dem Leser eines Hypertextes wird es
  45. dadurch ermöglicht, direkt zu den zu!-ge!-hö!-ri!_gen Abschnitten
  46. weiterzuklicken. Theoretische wäre es auch möglich, bei jedem Kapitel durch
  47. die Angabe des Befehls (!I)!/subtoc(!i) bzw. bei jedem Abschnitt durch die
  48. Angabe des Befehls (!I)!/subsubtoc(!i) diese Unterinhaltsverzeichnisse
  49. einzufügen. Bei kleineren Texten empfiehlt es sich jedoch, diese Ausgabe zu
  50. automatisieren.
  51.  
  52. Der Schal!-ter (!I)!/no_effects [asc](!i) schlieβlich sorgt für die
  53. Un!-ter!-drückung der Schrift!-ar!-ten für das ASCII-Format. Würde dieser
  54. Schal!-ter nicht angegeben, so würde UDO beim ASCII-Format die in der DFÜ
  55. gebräuchlichen Zeichen zur Schriftartumschaltung benutzen.
  56.  
  57. Das Kommando (!I)!/begin_document(!i) teilt UDO mit, daβ nun der Hauptteil
  58. des Quelltextes beginnt. Dieses Kommando darf in keinem Quell!-text
  59. feh!-len, da hier un!-ver!-zicht!-ba!-re In!-for!-ma!-tio!-nen für die
  60. Aus!-ga!-be!-for!-mate aus!-ge!-ge!-ben werden!
  61.  
  62. Zu Anfang geben wir eine Titelseite aus, die aus den Informationen aus
  63. der im oberen Teil des Vorspanns gebildet wird. Das Kommando
  64. (!I)!/maketitle(!i) sollte -- wenn es benutzt wird -- direkt hinter
  65. (!I)!/begin_document(!i) angegeben werden. UDO erlaubt zwar auch den Einsatz
  66. an späterer Stelle, jedoch ist dies weder sinnvoll noch unproblematisch.
  67.  
  68. Danach möchten wir, daβ UDO ein Inhaltsverzeichnis ausgibt. In diesem sind
  69. alle Kapitel, Abschnitte und Unterabschnitte des Quelltextes aufgelistet.
  70. Das oben Gesagte gilt auch hier. Wird der Befehl (!I)!/tableofcontents(!i)
  71. benutzt, so sollte er direkt hinter (!I)!/maketitle(!i) oder (bei Verzicht
  72. auf die Ausgabe der Titelseite) hinter (!I)!/begin_document(!i) angegeben
  73. werden.
  74.  
  75. Endlich! Nach dem ganzen Vorgeplenkel beginnen wir mit dem Befehl
  76. (!I)!/node(!i) das erste Kapitel. Beachten Sie bitte auch den Inhalt dieses
  77. Kapitels, da er weitere Informationen enthält.
  78.  
  79. Die folgenden Zeilen demonstrieren, wie man Kapitel, Abschnitte und
  80. Unterabschnitte erzeugt. Auch hier sollten Sie einen Blick auf den Text
  81. werfen.
  82.  
  83. Unser Quelltext ist nun beendet. Dies zeigen wir UDO mit dem Befehl
  84. (!I)!/end_document(!i) an. Auch dieser Befehl darf in keinem Quelltext
  85. fehlen!
  86.